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STWPC 6800 RESIDENT EDITGR AND ASSEMBLER MP-E 


The MP-E Editor/Assembler Package allows the user to considerably reduce 
the amount of time involved in writing programs. The editor allows one to com— 
pose or modify a program while easily making statement insertions, deletions and 
modifications. The assembler allows the program to be written using easy to 
remember mnemonic phrases like ADD (add), LDA (load accumulator) and BRA (branch 
always) instead of their hexadecimal equivalent. It also allows the use of 1 
to 6 character alphanumeric labels which eliminate the need for all of those cal- 
culations when using relative addressing. The editor and assembler are meant to : 
be loaded into the computer over standard 8 level paper tape or cassette tape 
through the MIKBUG ® serial control interface. When using the SWIPC AC-30 cas- 
sette interface follow the special instructions given for cassette tape. ” 


This manual is designed to supplement the information given in chapters 5 
and 6 of the MP-68 Microprocessor Programming Manual. Some of the information in 
these chapters pertains to a time sharing editor/assembler and is not relevant to 
the MP-E resident editor/assembler. ‘ 


Resident Editor 


The SWIPC-6800 Resident Editor may be used to create or modify alphanumeric 
text. In particular the Resident Text Editor facilitates the creation, correction, 
and modification of 6800 source programs. The SWTPC-6800 Resident Editor accepts 
input text from either the System Console Device or the System Reader Device and 
accepts edit commands from the Svstem Console Device. During a typical edit opera- 
tion, successive portions of input,text are transferred to the edit buffer, After 
editing, information in “te buffer is transferred to the System Punch or Record 
Device. 


Edit operations may be performed cn either characters or lines. To the 
Resident Editor, a character is any ASCII character. Non-printing characters 
such as CR and EOT are treated as characters by the Editor and can be manipulated 
accordingly. A line is a collection of characters delimited by Carriage Returns. 
(NOTE: When processing input text from the System Console Device, the editor echos 
a Line Feed with each carriage return entered. Text entered from the System Rea- 
der Device need not include Line Feed characters, since they will be supplied 
automatically following Carriage Returns in the Editor output. 


Edit operations are performed on portions of the text held in an edit buf- 
fer in the computer's memory. A buffer pointer is maintained to specify a cha- 
racter location within the edit buffer. Certain of the edit opeations are per- 
formed on lines or characters located with respect to the buffer pointer. It is: 
convenient to think of this pointer as being located between two characters. As 
shown in the example below, the buffer pointer is located between the D and E 
of RESIDENT. 


MOTOROLA M6800 RESIDENT EDITOR 


If tc’ e2Sident Editor is not already in memory, it may be loaded using 
the follow...g procedure (for paper tape). : 


(a) Place the Resident Editor object tape (paper tape) into the System 
Reader Device. ; 


MIKBUG R is a registered trademark of Motorola INC. 


. 
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(b) Enter. the MIKBUG R command "L". After the tape has loaded system con- 
trol will return to the MIKBUG R operating system. 


In normal operation, the memory region between the end of the Editor and 
the end of contiguous read-write storage is used by the Editor as the edit buf- 
fer. An 8K RAM system provides an edit buffer capacity of about 5700 bytes for 
paper tape and about 5100 bytes for cassette. 


To load programs from cassette using the SWIPC cassette interface in con- 
junction with the MIKBUG R control program use the following procedure: 


1) Switch motor control switch to MANUAL and the LOCAL/REMOTE switch to 
REMOTE. 

2) Place cassette in recorder, and rewind if required. : 

3) Enter MIKBUG R by pressing RESET if it is not already in MIKBUG R. 

4) Enter MIKBUG * command "EL" for load. 

5) Set the cassette interface READ status light manually if the read light 
did not come on. 

6) Switch the tape recorder to the PLAY mode. 

7) When "*" appears, turn off cassette. 


When the Resident Editor is present in memory it may be initiated by set- 
ting the program counter A94816 and A@4916 to $1 and $9 respectively and by 
utilizing the "Go To User's Program" command G. The computer should then res~ 
pond with "M6800 Resident Editor". The Resident Editor prints "@" in the left 
margin as a prompt whenever it is waiting for a command. Commands to the Resi- 
dent Editor are single characters entered from the System Console Device. Some 
Editor commands have arguments associated with them. Editor commands must be 
terminated by two ESC ($1B) characters. (Since CR is a legal text character, it 
could not be used for command termination.) The two ESC characters mark the end 
of a command and cause the Editor to begin execution. (NOTE: Since ESC is a 
non-printing character, the Editor echoes "S$" whenever ESC is entered.) 


The Resident Editor commands are described in the following’ paragraphs and 
summarize in Table 2-1. : 


For purposes of description, the commands are grouped into four categories: 


. Input/Output Operations 
Buffer Pointer Operations 
Edit Operations 

. Exit Editor 


RwWNnre 


Input/Output Operations 


Input/Output Operations control the transfer of information between the 


edit buffer and the System Reader Device, System Punch or Record Device, and the System 


Printer Device. 


A — APPEND 
FORMAT: A 


DESCRIPTION: The Append command causes input text to be transferred from the System Reader Device and appended 
to the Edit buffer. The transfer is terminated by one of the following conditions. 


(1) End of tape 

(2) End of file character ($1 A) 
(3) Workspace full 

(4) 50 lines read 


Null, rubout, LF, ESC, Backspace (Control H). Cancel (Control X). Readeron. Punchon. Readeroff, Punchoff, and EOF 
characters are deleted from the input text. 
If the Editor is unable to read the input text (Reader Device. off. etc.). it will time-out and print a ‘‘@”’ as a 
prompt for a new command. 
. If the workspace allows, more than 50 lines may be entered by repeating the A command. 


EXAMPLE: Assume that the Editor has been loaded into memory and is running. Also assume that a tape containing the 
following information has been loaded into the System Reader Device. 


10 HAM PEM ecko oLF 
2h OTF M MEMORY FILE OFTION CIR ¢LFs 
an DFT O OUTPUT OBJECT TAFE (LF * 
40 OFT = SELECT FRINTING SYMBOLS CCR CLP 
S0 ORD StSe c0R el 
BO LTA F ADDR CCR CLP 
FO COUNT Emu as oo INDICATES OCTAL “CR fLFo 
SO ETART LDS eiTAck INS STACK FOINTEP OCk CLF 
a0 LDR ADDR ecko tLe 
too LDR BE «COUNT IMMEDIATE ADDRES. ING ocr CLF 
110 BACK LDA A in DIRECT ADDR : 
120 CMF A Sse IMDESED ADDRE 
120 BE FOUND RELATIVE ADORE: HEC CLP 
140 TES _ IMPLIED ADDRESSING eles tLe 
150) DEC B ACCUMULATOR ONLY ADDRESSING eck CLF 
160 EBHE BARK ook) «Leo 
Trt WAT WAIT FOR INTERRUPT coro flees 
Lan SPC 1 cee (Leo 
130 FOUHD Je SUEBRTN JUMP TO SUBROUTINE ocr? ¢Leo 
2nu AMF START EXTENDED ADDRESSING CCR SLES 
210 ¢ COMMENT ETATENENT NOTE TRUNCATION K 
220 SUEBRETM TAB COMMENT FIELD TRUNCATION S245 SIRS CLF 
OFA A BYTE FET MOTT S1GNIFICANT BIT ecrs «LPs 
PTS FETURM FROM SUBROUTINE ce: oF 
SPC Sones «Leo 
BME €0 ILFATCH ARER FOR STACK oc le 
STACK FME 1 TTARPT OF =TRIE coro «Lee 
BYTE FOE $0 FORM CONSTANT BYTE cCR KLE 
FILE $i0s%4 & INDICATES HESADEC IMAL ces «LE 
ADDF FOE DATA FORM CONSTANT DOWELE BYTE ote: °Le% 
DATA FO “TET. FORM CONSTANT DATA ZTRING ooo eRe SLRs 
ENDcc&k 7 Lee 
MON We! Les cEOTs 


meg a wp 


WO de ROG fu fe 


i fet 
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A — APPEND (continued) 


Entering the A command loads the contents of the tape into the edit buffer. 


d 
TARE 


Bu 


If the Editor was just entered. the edit buffer is empty prior to the A command. Then. following the A command. the 
contents of the tape are loaded into the edit buffer until the buffer is full or the end of the tape is reached. 


If the edit buffer was not empty prior to the A command, the amount of text entered into the edit buffer is dependent upon 
the four conditions listed above. 


NOTE 
The previous examples assume that the contents of the tape listed above are the only contents of the edit 
buffer. Remember that Line Feeds are not entered into the edit buffer. User entries in the examples will be 
underlined with $ indicating ESC. Notice that a m:..imum of two spaces are required between a line number 
and an instruction without a label and only one space is used between a line number and label. 


E — END EDIT OPERATION 
FORMAT: E 


DESCRIPTION: The End command terminates the edit operation and causes the contents of the edit buffer to be 
transferred to the System Punch Device. The remaining text is then copied from the System Reader Device to the System 
Punch Device. When an EOF is encountered on the input tape. or the tape ends. an EOF and blank wailer are written to the 
output tape. Upon completion. the Editor prints *@" and waits for further commands. The contents of the edit buffer are 
still available for editing. The buffer pointer remains at its previous position. The E command does not cause leader to be 
punched. 


F — TAPE LEADER/TRAILER 
FORMAT: F ‘ 


DESCRIPTION: The Tape Leader/Trailer command writes fifty NULL characters to the System Punch Device. This 
command may be used to produce Leader/Trailer for paper tapes. 


P — PUNCH 


FORMAT: nP 
n is a positive decimal integer less than 256. If omitted. the Value :s assumed to be I. 


DESCRIPTION: The Punch command causes a specitied number of lines (n). beginning with the line specified by the 
buffer pointer. to be written from the edit buffer to the System Punch Device. The lines are deleted from the edit buffer. Ifa 
negative number n is entered. the negative sign is ignored and a positive n number of lines are punched. 


T — TYPE 


FORMAT: nT 
n is a decimal integer in the range —254 <n < 255, If omitted. the value is assumed to be 1. 


DESCRIPTION: The type command causes a specified number of lines (n) to be orate $n the System Console Device. If 
nis positive. the first line typed is the current line (the line indicated by the current position of the buffer pointer). [fn is 


negative. the n lines preceding the current line are typed. If fewer than n lines exist following (preceding) the end 
(beginning) of the edit buffer. only these lines are typed. . 
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T — TYPE (continued) 


EXAMPLE: 
JIT EE 
a0 OFT © SELECT PRINTING 2yMEOLS 


sO ORG S132 
eo CIA EF ADDR 

FO COUNT Eel oes oot INDICATES OCTAL 
HO STRRT LIS eiTACk INS TACK FOINTER 


POT RE 

PrLNT EE 

10) MAM Fir 

eno OTP M MEMORY FILE OFTION 
20 OFT O OUTFUT QEJELT TAFE 


PLEE mr 
$0 OFT & SELECT PRINTING =YNEOLS 


at 


‘The ST types the five lines following the buffer pointer location. Note that the buffer pointer is currently at the beginning of 
the fourth line of the edit buffer. 


No lines are printed by the OT command. If the buffer pointer 1s inside a line. the OT command will print the characters 
from the beginning of the line to the buffer pointer. 


The — 10T command prints the lines from the current buffer pointer location to the beginning of the edit buffer since there 
are less than 10 lines from the buffer pointer to the beginning of the edit buffer. 


The command T prints the single line following the buffer pointer since the Editor assumes a one preceeds the T. 
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BUFFER POINTER OPERATIONS 
Buffer pointer operations are used to manipulate the position of the edit buffer pointer. 


B — BEGINNING 


FORMAT: B 
DESCRIPTION: The Beginning command moves the edit buffer pointer to the beginning of the edit buffer. 


EXAMPLE: 


OFT & SELECT FRINTING 21MEOLS 


The line printed by the first T command is the fourth line in the edit buffer indicating that the buffer pointer is at the 
beginning of the fourth line. 


The B command moves the buffer pointer to the beginning of the edit buffer. 
The final T command causes the first line to be printed out confirming that the buffer pointer is at the beginning of the edit 
buffer. 

Z — END OF BUFFER 


FORMAT: Z 
DESCRIPTION: The End of Buffer command moves the edit buffer pointer to the end of the edit buffer. 


EXAMPLE: 


TEE 
10) MAM Fist 


Initially the buffer pointer is at the beginning of the edit buffer as the first T command indicates by printing the first line. 


The Z command moves the buffer pointer to the end of the edit buffer. 
The —1T command prints the line immediately preceeding the buffer pointer location, in this case the last line of the edit 
buffer. 
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MOVE CHARACTER POINTER 


FORMAT: nM 
n is a decimal integer in the range —254 < n < 255, If omitted. the value is assumed to be |. 


DESCRIPTION; The Move Character Pointer command moves the edit buffer pointer according to the number of 
characters specified by n. If nis positive. the pointer is moved forward n characters. If negative, the pointer is moved back 
n characters. If fewer than n characters are present between the initial buffer pointer and the end (beginning) of the edit 
buffer, the pointer is moved to the end (beginning) of the buffer. 


EXAMPLE: 


v4 TEE 
10 NAM OP 

eo OTF M MEMORY FILE OFTION 

30 OFT O OQUTFLUT OBJECT TAFES: 

$0 OFT 2 SELECT PRINTING i+MEOLS 


MEMORY FILE OFTION 


MEMORY FILE OF TION 


The 4T command prints the first 4 lines of the edit buffer indicating that the buffer pointer is at the beginning of the edit 
buffer. 


The 3M command moves the buffer pointer forward 3 characters. 


The 2T command demonstrates this by printing the current line. beginning at the buffer pointer location. and the next line. 


The —1T command prints the previous line, which in this case is the information from the beginning of the edit buffer to 
the current buffer pointer location. 


The buffer pointer is moved forward eight characters by the 8M command. Now the buffer pointer is at the beginning of the 
second line in the edit buffer as the T command demonstrates. 


The — 1M command moves the buffer pointer back one character to Just before the Carriage Retum at the end of the first 
line of the edit buffer. Now the T command prints only the Carriage Return, which is the remainder of the line it is in,anda 
Line Feed. 
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L — LINE 
FORMAT: nl 
n is a decimal integer in the range —254 < n < 255. If omitted. the value is assumed to be 1. rm 


DESCRIPTION: The Line command moves the edit buffer pointer according to the number of lines specified by n. [fn is 
positive, the pointer is moved forward n lines. If negative. the pointer is moved backward n lines. A value of 0 causes the 
pointer to be moved to the beginning of the current line. If fewer than n lines are present between the initial buffer pointer 
and the end (beginning) of the edit buffer. the pointer is moved to the end (beginning) of the buffer. 


NOTE 
The M6800 Text Editor considers a line to be a sequence of characters delimited by Carriage Returns. 


EXAMPLE: 
PATER 
MAM PSM 
OTF M MEMORY FILE OPTION 
OFT O OUTRLIT OBJECT TAFES 
GPT § SELECT PRINTING i\MFOLE 


‘Pa 


SELECT PRINTING fYMECLS 


MEMORY FILE OFTION + 


M MEMORY FILE OFTIOM 
SIL kek 


Fok 
OTF mM MEMORY FILE OFTION 


The 4T command prints the first four lines of the edit buffer indicating that the buffer pointer is at the beginning of the edit 
buffer. 


The 3L command moves the buffer pointer forward three lines. 


The T command then prints the fourth line of the edit buffer. 


The —2L command moves the buffer pointer back two lines. 


Now, the T command prints the second line of the edit buffer. 

The 8M command moves the buffer pointer forward eight characters. 

This is confirmed by the T command which prints only a portion of the second edit buffer line. 

The command OL causes the buffer pointer to move to the beginning of the line that it is currently in. = 


The final T command illustrates that the buffer pointer did move to the beginning of the second line. 
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S$ — SEARCH 


FORMAT; Sstring ; 
The ‘‘string” argument is a string of 16 characters or less. made up of any ASCTI characters except ESC and BREAK. 


DESCRIPTION: The Search command causes a search of the edit buffer for the first occurrance of the specified string. The 
search begins at the buffer location specified by the current position of the buffer pointer. The search may be terminated in 
two ways: 


(1) A match with the specified string is found. In this case. the buffer pointer is positioned immediately after 
the last character of the matched string. 


(2) The search reaches the end of the edit buffer. In this case. a message 
CAN'T FIND “string” 


is printed. When no match is found, the buffer pointer remains in its initial position. 


EXAMPLE: 
VEEE 


Teh 
OFT & SELECT PRINTING =YMEOLS 


SEOTEEE 


LAN’ T FIND “OTP” 


JERE 
JLOTREE 
SOL BE 


TRE 


— 


eno OTF M MEMORY FILE OFTION 


The B command sets the buffer pointer at the beginning of the edit buffer. 
The $40 command searches for 40. © 


Since the Editor came back with @. it found 40 and positioned the buffer pointer immediately after it. The T command 
demonstrates this by printing the portion of the line numbered 40 which follows the 40. Note that if line numbers are 
included in the program being edited. the Search command can be used to easily move the buffer pointer to any given line 
by searching for the appropriate line number. 


The SOTP command searches for OTP. - 


The Editor printed CAN'T FIND “OTP” indicating that OTP does not occur between the current buffer pointer location 
and the end of the edit buffer. 


Then the B command moves the buffer pointer to the beginning of the edit buffer. 
Now OTP is searched for again by re-entering the command SOTP. 


This time the Editor prints only @. indicating that it found OTP. The OL command moves the buffer pointer to the 
beginning of the line containing OTP. 


The T command prints the line containing OTP. 
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INSERT/DELETE/CHANGE 
OPERATIONS 


These operations permit the insertion of text 
into the edit buffer. deletion of text in the buffer. or 
replacement of an existing character string with another 
string. 


] — INSERT 


FORMAT: ltext 
The “*text’? argument may include any ASCII characters except ESC and CANCEL. 


DESCRIPTION: The Insert command is used to insert lines or characters of text into the edit buffer. Text is inserted at the 
location specified by the current buffer pointer. Following the Insert operation. the pointer is positioned after the last 
character of inserted text. The ASCII characters Null. Rubout. Linefeed. Backspace. Readeron. Punchon, Readeroff. and 
Punchoff are deleted from the inserted text by the Editor. 


EXAMPLE: 


ETRE 
HAM PSM 
OTF mM MEMORY FILE OFTION 


mIIS  ¢ REVISION 1 


10) WAM Fist 
13 @ FEVITION 1 
eo OTF mM MEMORY FILE OFTION 


BY 


The B command sets the buffer pointer at the beginning of the edit buffer. 

The 2T command prints the first two lines of the edit buffer. 

The 2M command moves the buffer pointer to immediately past the 0 to 10. 

The { (Space) command inserts a space at the current location of the buffer pointer. 


The L command moves the buffer pointer to the beginning of the next line so that a line can be inserted between the lines 
numbered 10 and 20. 


The 11S *REVISION 1 (Carriage Return) command then inserts the line numbered 15 between the lines numbered 
10 and 20. 


The B command sets the buffer pointer at the beginning of the edit buffer. 


The 3T command then prints the first three lines of the edit buffer and confirms that the information was inserted. 
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D —i DELETE CHARACTERS 


FORMAT; nD 
n is a decimal integer in the range —254 <n < 255. If omitted. the value is assumed to be 1. 


DESCRIPTION: The Delete Characters command deletes n characters from the edit buffer, beginning at the current 
Position of the edit buffer pointer. If n is positive. n characters following the current pointer position are deleted. If 
negative, n characters preceding the current pointer position are deleted. If there are less than n characters between the edit 
buffer pointer and the end (beginning) of the edit buffer. then the characters will be deleted and the buffer pointer will point 
to the end (beginning) of the edit buffer. 


Ba 9 

HAP Fast 

* REVIZTON 1 

OTF MN MEMORY FILE OFTION 
OFT O OUTFLUT QRJECT THREES 


VOTAPE DEE 


S-LIVEE 

VAT BE 

10) NAM FSM 

1S @ REVIZION 1 

eo OTF M MEMORY FILE OFTION 
20 OFT O OQUTFUT ORJECT TAFE 


BY 


The B command sets the buffer pointer at the beginning of the edit buffer. 

The 4T command prints the first four lines of the edit buffer. 

The S15 command searches for 15 and locates the buffer pointer immediately after it. 

The D command deletes the character after the buffer pointer. in this case a space. 

The STAPES command searches for TAPES and positions the buffer pointer immediately after it. 
The -—1D command deletes the character before the buffer pointer. which is the S of TAPES. 


The —4T command prints the four lines preceeding the buffer pointer and confirms that the changes: were made. 
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K — KILL (DELETE) LINES 


FORMAT: nk : 
n is a decimal integer in the range —254 <n < 255 If omitted, the value is assumed to be |. 


DESCRIPTION: The Kill Lines command 1s similar to the Delete Characters command. except that n specifies a number of 
lines to be deleted from the edit buffer. rather than a number of characters. If nis positive. n lines following the current 
pointer position are deleted. If negative. n lines preceding the current position are deleted. If fewer than n lines remain 
between the current pointer position and the end (beginning) of the edit buffer. then the lines are deleted and the buffer 
pointer will point to the end (beginning) of the edit buffer. 


If nis zero. the characters between the buffer pointer and the immediately preceeding Carriage Return will be deleted. 


EXAMPLES: 
EEE 


PETER 


10 HAM Pi 

15 ¢ RFEWIEION 1 

en OTF m MEMORY FILE OFTION 

so OFT O GUTFUT GCEJECT TAFE 

a9 OFT 2 TELECT FPRIMTING 2£YMEDLS 
So OFS = 


LIA 


PTE 


10 HAM PS 
5 ¢ FEVITION 1 
eo OTe m MEMORY FILE OFTION 
30 CFT O QUTFUT DELECT TAFE 
30 OFT % TELEDT FRIMTING 2vMNEOLE 
so ORR S13e 
COUNT Emil ge ot TIMDICATE? OCTAL 


The B command sets the buffer pointer to the beginning of the edit butfer. 
The 7T command prints the first seven lines of the edit buffer. 

The S60 command searches for 60 and sets the buffer pointer immediately after it. 
The OL command moves the buffer pointer to the beginning of the line numbered 60. 


The K command deletes the line that the buffer pointer is currently at. If the buffer pointer were somewhere else besides the 
beginning of a line, the K command would delete the characters from the buffer pointer through the following Carriage 
Return. 

40.The B command sets the buffer pointer to the beginning of the edit buffer. 


The 7T command prints the first seven lines of the edit buffer confirming that the line numbered 60 was deleted. 
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C) 


C — CHANGE 


FORMAT; Cstring | Sstring2 ‘ 
“string 1"" and ‘‘string 2”’ are strings of 16 ASCII characters or less. These strings may include any ASCII characters 
except ESC and BREAK. The two strings need not be of the same length. 


DESCRIPTION; The Change command searches the edit buffer from the current buffer pointer position. When the first 
occurrance of *‘string |*' is found, those characters are changed to “‘string 2°". The buffer pointer will be moved to the end 
of **string 2°’. 
If **string 1°’ cannot be found. the message 

CAN'T FIND “string 1” 


is printed, and the position of the buffer pointer is unchanged. 


EXAMPLE: 
SEES 


JSTER 

10 HAM POM 

1S) ¢ REVISION 4 

en OTF M MEMORY FILE OF TION 

20° OFT O OUTPUT ORJERT TAFE 

40 OFT & SELECT PRINTING SYMBOLS 


SLEVYMEOLSEOE EYMEOLE ER 


SCOTPEOPT ESE 
CAN’ T FIND “OTF” 
EEE 


COTE EOP T EE 
ERE 


SITET 
it) MAM 
15 @ REVISION 1 

eo OFT M MEMORY FILE OFTION 

20 OFT O OUTFIT OBJECT TAFE 

$0 OFT & SELECT PRINTING OF SYMEOLS 


The B command sets the buffer pointer at the beginning of the edit buffer. 
The ST command then prints the first five lines of the edit buffer. 


The CSYMBOLSSOF SYMBOLS command searches for SYMBOLS and substitutes for it OF SYMBOLS. The 
COTPSOPT command searches for OTP. However, the Editor prints CAN'T FIND **OTP” indicating that OTP does not 
occur between the current buffer pointer location and the end of the edit buffer. 


The B command moves the buffer pointer to the beginning of the edit buffer so that the complete edit buffer can be searched 
for OTP. ; 


This time the command COTPSOPT locates OTP and substitutes OPT for it. 
The B command sets the buffer pointer at the beginning of the edit buffer. 


The 5T command prints the first five lines of the edit buffer and confirms that the changes were made. 
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RRS EN 


. 


EXIT EDITOR 
x 
FORMAT: X 


DESCRIPTION: The X command causes control to 
be returned to the MIKBUG program. 


EDITOR COMMAND CHAINING 


The M6800 Resident Editor can accept sequ- 
ences of edit commands. A command sequence consists 
of a sequence of editor commands and associated argu- 
ments, terminated by two ESC characters. Commands 
with arguments which follow them must be separated 


“from subsequent commands with a single ESC character. 

Two ESC characters mark the end of a 

command string and cause the Editor to begin execution. 

Commands ina string are executed from left-to-right, in 

the order in which they were entered. All commands 

preceedin an illegal command in the command chain are 
executed. 


EDITOR COMMAND CHAINING EXAMPLES 


The following example assumes that the in- 
formation contained on the tape in the Append Example is 
the only contents of the edit buffer. 


PEST EE 

10 HAM Pip 

eo OTF Mm MEMORY FILE OFTION 

tn OFT O BUTFLIT OBJECT THREES 

dm GET 2 TELECT PRINTING tYMEOLS 
So OF Biss 

a0 LDA E Abie 

TO COUNT Emi see 3 IMDICATE: O0.TRL 
So LTARPT LOT stTACk INE ITACK FOINTER 
HEMT EMNLTLE BE 

io yar Bats 


PLAOBILE LED TSS SEOLTCOTEEOR TEL 


7H COWMAT Ems ys 


TAM T FIND “OTe 


PETSOTP OFT 


SECOTPROFTEELIAS 


D ENPICATE: OCTAL 


o FEVITETON 1 


' BLS MEOLSE-FMIOFE 


PERSTE EE 
10 MAM Paes 
S @ FEVTCION 1 


BS oe 


4 


en OFT m mEMGe: FILE OFTION 

a0 OFT O GUTFUT QERJELT TREE 

40° OFT 2 TELECT PRINTING GF IYMEOLE 
S00 ORG 21s 

Th COUNT Em gr og IMEC ATES OOTAL 
Bo TTART COD eit Teach int ITA POINTER 


3! 
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. The B8T command chain sets the buffer 
pointer at the beginning of the edit buffer and then prints 
the first eight lines of the buffer. 

The next command chain. 2MI SOLTCSSS. 
does the following: 


1. Moves the buffer pointer forward two characters 
(2M). 


2. Inserts a space (I $). 


3. Moves the buffer pointer to the beginning of the cur- 
rent line (OL). 


4. Prints the line (T). 


5. Moves the buffer pointer to just after the next S in the 
buffer, which is in TAPES, and then deletes the S 
(CS$$). Note that the C command can be used to 
delete character by not including a string 2 in the 
command, However, when used in this manner. the C 
command can only occur as an individual command or 
at the end of a command chain since two ESC charac- 
ters must occur together due to the deletion of stnng 2. 


The command chain 
S60SOLKS@SDI993SOLTCOTPSOPTSS 
performs the following actions: 


1. Searches for 60 and moves the buffer pointer to just 
after it (S60$). 


2. Moves the buffer pointer to the beginning of the line it 
is in (OL). 
3. Deletes the line (K). 


4. Searches for @ and moves the buffer pointer to just 
after it (S@$). 


5. Deletes the next character, which is 8 (D). 


6. Inserts a 3 (19(backspace)3$). Note that a 9 was er- 
roneously entered and was deleted using a backspace 
(Control H) character. The backspace character may 
be used to delete as many previous characters in a 
command as required. The Editor prints the character 
deleted by each backspace. 


7. Moves the buffer pointer to the beginning of the line 
the buffer pointer is currently in (OL). 
8. Types the line the buffer pointer is currently at (T). 


9. Searches for OTP (COTPSOPTSS). But the Editor 
does not find it between the current buffer pointer 
location and the end of the buffer as it indicates by 


printing CAN’T FIND “OTP”. 

The command chain BTSOTP$OPT was not 
executed since a Control X character terminated the 
command chain. The Control X character deletes all 
commands up to the last prompt and prints another 
prompt. 

The command chain BCOTPSOPTS$BLII5 * 
REVISION 1(CR)SSSYMBOLSS — 7MIOF $$ does the 
following: 

1. Moves the buffer pointer to the beginning of the edit 
buffer (B). 


2. Changes OTP to OPT and moves the buffer pointer to 
Just after OPT (COTPSOPTS). 


3. Moves the buffer pointer back to the beginning of the 
edit buffer (B). 


4. Moves the buffer pointer to the beginning of the next 
line (L). 


5. Inserts the line 15 * REVISION | at the current buffer 
pointer location (11S * REVISION I (CR)$). Note that 
to insert a line the buffer pointer is moved to the 
beginning of the line that is to follow the inserted line. 
Then the line is inserted using the I command. A 
Carriage Return should be the last character of the 


inserted line. 
6. Searches for SYMBOLS and moves the buffer pointer 
to just after it (SS YMBOLSS). cy 


7. Moves the buffer pointer back seven characters 
(~—7M) which puts it at the beginning of SYMBOLS. 


8. Inserts OF(space) at the current buffer pointer location 
(OF $8). 


; The following actions are performed by the 
command chain B8TE: 


1. Moves the buffer pointer to the beginning of the edit 
buffer (B). 


2. Prints the eight lines following the current buffer 
pointer location (8T). 


3, Ends editing on the contents of the edit buffer by 
punching a tape of the buffer contents and any remain- 
ing tape in the System Reader Device (E). 


RESIDENT EDITOR MESSAGES 


Table 2-2 lists and identifies the Resident 
Editor messages. 
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TABLE 2-1 EDITOR COMMAND SUMMARY. 


DESCRIPTION 
Append. Appends input text from the System Reader Device to the edit buffer. 


A er 


Tas Be or : Beginning. Moves the edit buffer pointer to the beginning of the edit buffer. 
Cstring!$ Change. Replaces the first occurrance of **string 1"* with “string 2°", 
" --"string2' } f° 


Delete. Deletes n characters from the edit buffer. 


‘End. Terminates an edit Operation by writing the contents of the edit buffer to the Output tape and 
copying the remainder of the input tape to the output tape. 


Tape Leader/Trailer. Writes 50 NULL characters to the System Punch Device. 


Insert. Inserts characters or lines of text into the edit buffer. 


Kill lines. Deletes n lines from the edit buffer. 


Line. Moves the edit buffer point n lines. 
Move character pointer. Moves the edit buffer pointer n characters. 


Punch. Punches n lines from the edit buffer to the System Punch Device. 


Search. Searches the edit buffer for the first occurrance of **string’*. 
Type. Types n lines from the edit buffer to the System Console Device. 


EXbug. Returns control to EXbug. 
End of edit buffer. Moves the edit buffer pointer to the end of the edit buffer. 


~ Causes the last character entered in the command mode to be typed on the System Console Device and 
deleted from the command. 


Control A 


Control X Causes all commands following the last prompt to be deleted and another prompt to be typed. 


TABLE 2-2. RESIDENT EDITOR MESSAGES 
DESCRIPTION 


Printed upon initiation of editor. 


M6800 RESIDENT EDITOR 


@ Prompt. Editor is waiting for a command. 
mee 2292 INegal command. : 
CAN'T FIND ‘string’ Editor cannot find the string specified by Search or Change command. 
BELL The Editor rings the bell in the Svstem Console Device when the user attempts to 


enter further commands into a full command buffer. The user must delete (back- 
Space) two characters in order to terminate the command with two ESC characters. 
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Resident Assembler 


The SWIPC-6806 Resident Assembler may be used with the computer to translate 
source programs for the 6800 Microprocessor to object form. The M6800 Micro- 
processor Programming Manual describes the common features of the assembler and 
errer messages. This description emphasizes features and procedures unique to 
the Resident Assembler. 


s-, ,Standard input to the Resident Assembler is a source language tape read 
by the System Reader Device. 


The Resident Assembler produces two output forms, an assembly listing and 
an output tape. 


The assembly listing includes both a formatted output of the source pro- 
gram and a listing of the generated machine instructions. This listing is pro- 
duced on the System Printer Device. 


The object output is optionally written to the System Punch or Record Device. 


to eight characters from the address’ field of the NAM directive will be inserted 
in the header record of object tapes produced by the Resident Assembler. 


The OPT M feature described in the M6800 Programming Manual is not present 
in this assembler. 


The Resident Assembler must be present in the computer's memory prior to 
the initiation of the assembly operation. However, it is not always necessary 
to load the assembler before each assembly. If several programs are assembled 
in succession, or if programs are tested without modifying memory locations used 
by the assembler, then the assembler will remain intact in memory and available 
for subsequent uses without reloading. 


In the event that the Resident Assembler must be loaded, the procedure 
given to load the Editor should be followed using the assembler tape. 


To initiate the assembler the program counter Af48 and A®49 should be set 
to $196 and the program initiated with a "G". 


When using the SWTPC Cassette tape interface be sure to read the special 
cassette tape instructions at the end of this manual. 
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ASSEMBLER OPERATION 


The Resident Assembler is a two-pass assem- 
bler. That is, the Resident Assembler must read a source 
program twice — once to build a symbol table, and a 
second time to produce the assembled output. In response 
to the assembler prompt message 


ENTER PASS: IP, 1S, 2P, 2L, 2T 


select the appropriate assembler pass. The Resident As- 
sembler Pass controls are described in the following 
paragraphs and are summarized in Table 3-1. 


TABLE 3-1. RESIDENT ASSEMBLER PASS 
CONTROLS AND OPTIONS 


CONTROL DESCRIPTION 


IP Pass 1, clears symbol table. 
1S 


Pass |, inhibits clearing of symbol 
table. 


2P 


Pass 2, assembly listing & object 
tape output. 
Pass 2, assembly listing only. 


2L 
2T 


Pass 2, object tape only. 


PASS IP — Pass | produces a table of the symbols which 
appear in the program and the corresponding memory 
addresses to which they are assigned. This table is used in 
Pass 2 to determine the address field for instructions 
which reference memory symbolically. Program syntax is 
also checked in Pass 1, and errors are listed. 


Pass I Option: 

1§ — In the assembly of multiple source tapes, 
it may be advantageous to preserve the symbol table 
between successive tapes. This permits all symbols to be 
known to each assembly. The S option for Pass | inhibits 
the clearing of the symbol table before the pass is started. 


PASS 2P — Pass 2 rereads the source tape and uses 
information in the symbol table to produce the assembled 
output. Using terminals which permit independent on/off 
control of the tape output and printer devices, Pass 2 can 
produce both an object tape and an assembly listing. A 
terminal without independent controls will permit the 
generation of either an object tape or an assembly listing 
{not both}. In this case, Pass 2 may be repeated to 
generate both output forms. 


Pass 2 Opttuns: 

2L — The L option for Pass 2 is used to 
generate only an assembly listing (no object tape). 

2T — The T option for Pass 2 is used to 
generate only an object tape (no assembly listing). 
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NOTE 

One-Pass Operation. For source programs 
which have no symbolic forware references, 
Pass | may be omitted. For short programs 
with only a few forward references, it is also 
possible to omit Pass 1. In this case, forward 
references will be flagged with error 211 and 
assembled with an address field of FFFF. The 
correct address can be patched after the sym- 
bol table is printed at the completion of the 
assembly. 


In combination with the options for entering a 
source program from the terminal keyboard 
and for assembling an object program in 
memory. short programs may be assembled 
and executed without the use of tapes. 


3-7 ASSEMBLER DIRECTIVE OPTIONS 


Output from the assembler can be generated or 
altered by using the following assembler options. Multi- 
ple comma-separated options may be specified with a 
single statement. 


OPT O The assembler will generate object 

(object tape) tape. 

OPT NOO No object tape (selected by default). 

OPT M : 

(memory file) Not part of this assembler 

OPT NOM No memory (selected by default). 

OPT S The assembler will print the symbols 

(print symbols) at the end of Pass 2. 

OPT NOS No printing of symbols (selected by 
default). 

OPT NOL The assembler will not print a listing of 

(no listing) the assembled data. 

OPT L The listing of assembled data will be 
printed (selected by default). 

OPT NOP The assembler will inhibit format 

(no page) paging of the assembly listing. 

OPT P The listing will be paged (selected by 
default). 

OPT NOG Causes only | line of data to be listed 

(no generate) trom the assembler directions FCC, 
FCB. FDB. 

OPT G AH data generated by the FCC, FCB 


and FDB directions will be printed 
(selected by default). 


A couplete descziption cf each of the assembler directives can be found 
in Appendix B of the ‘68a Microprocessor Manual, Appendix C lists the error 
Messages that can be encountered during an assembly operation. Chapters 5 and 
6 of the Programming Manual also contain mich useful information on assembler 
use and operation. =6 G.o, Timeshare examples given do not pertain to the SWTPC 
6800 Resident asccu 


The assembler has a few design features which may prove important to the 
hobbyist: 


1) Ail forward references to data are resolved by using extended ad- 
dresses, even if the data can be addressed directly. The code 
produced works, but wastes much space. Any data that can be ad- 
dressed directly should be defined (used as a label) before it is 
referenced. 


2) The assembler will not reduce JMP and JSR to BRA and BSR, even if the 
target address is within range. Again, this works, but wastes space. 


3) Conversely, the Assembler can not substitute JSR and JMP for BSR and 
BRA if the target address is outside the range of relative address-— 


ing. This is an inconvience. 


4) Duplicate symbol definitions confuse the assembler, It will lose 
both definitions and resolve addresses incorrectly. 


5) DO HOY mis-srell the assembler "END" directive. I£ you accidentally 

spell “ED or "EXE", the assembler «ill enter an inzinite loop of 
"ERROR 227" and “ERROR 265", 

6) The assembler dves not write out the starting address of your pro- 
gram ~ you will have to get this yourself when you load the program. 


7) The assembler siil not punch an object tape when either the 2T or 2P 
pass is selected unless the source program contains an OPT 0 directive, 


= Special Cassette Tape Instructions 


The SuTPC-43825 
minimum of memory and s 
the edit buffer is 2 
the cassette iurerfac 
grams of a very large s 


sectte editer is a resident editor that requires 4K 

orts the SWIPC AC-30 Cassette Interface. With 4K RAM, 
Using two recorders with 
evides the capability of creating and maintaining pro- 


Two cormands have beer appended to the paper tape editor to support the 
cassette interfuca, The first command is the "U" command, which specifies which 
I/O port is used for the cassette. Default is 1, or the control interface. If 
a different port has been used, the user must use the "U" emmand to change the 
address used by the eidtor. For example, if Porc 3 has been used, you must enter 
@3US$ to specify port 3. (Note that @ is the editor prompt, and $ is the escape 
character.) 


The second commend 
and startup/step times of 


ed by Che variation in speed tolerances 
recorders. When the editor was used 
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wijh paper tape, 
it would be from ch 
was transmitted. If 
end of the tape had 
blank, it is filled 


considerable accuracy how long 
d was issued until a character 
n this time, one could assume the 
blank paper tape isn't really ; 


will vot work for cassette tape. Blank 

Et .ecscccord gaps) and it is difficult to 
Predict the length of th cS with eccuracy. Therefore, the editor 
input routine has been modif to time out for lack of data. The only 
time this presents a problem is when there is no input tape at all. To this 
end, a command "N" (NO input) has been provided. When creating a program for 
the frist time, and there will be no input data, the "N" command must preceed 
the "E" (end) command. 


Unfortunately, the 
Stretches of tape £ 


a 


Spot 


At this time it will be inforrative to 30 through the process of creating 
a program using the SWIPC editor. We start with a blank or/erased cassette tape, 
First, load the SWTPC editor from cessetre. It's starting address is $109 so we 


set it up (Underlined. characters are typed by MIKBUG Ry and fire up the editor: 


Now we puc the 
the cassette inte 
the record mode, b2 
with the Record STAT hat 
editor is alive, so stert La hoger 


end rewind it, if necessary. Set 
?O" and turn the recorder ON in 
Switch is set to the center position 
‘éil - the interface is ready, the 

2 “rogram ($ is ESC, @is a prompt): 


b8C3 EDITOR F 


ww kb t 


MEMORY 


BACK TO MIKBUG 


Checking our work, we f 
in (1), and used the libel "\ 
this: 


1) We typed "CLT" instead of "CLR" 
nstea! of "CM" in (2). So we go back and fix 


LTS TLE SLTCVMSOMS-OLTSS 


CM CLR X 
BNE CM 


|l@ 


(Hint: after a change "C" command, the commands "-OLT" will cause the 
changed line to be typed). Everything looks good so let's finish. Remember, 
there is no input tape so we must use the "N" command: 


@ FNESS 
At this point, the editor will write a leader ("F"), configure itself 
for no input tape ("N'") and write out the program ("E"). When this is finished, 
the tape will contain the program, properly blocked for the assembler. 
Both the editor and assembler use blocked source code on cassette, for 


noise immunity and to achieve more efficient use of the media. Each block of 
data is 132 bytes long, in the following format: 


ps] eon ep 


The data consists of non~space-compressed source lines delimited by (CR)'s 
(@D's). A control - Z (1A) is used for the end-of-file character and cannot be 
used as data. 


Both the editor and the assembler have a Startup address of $190. The 
Memory maps are as follows: : 


EDITOR ASSEMBLER 


scraTcn | 9028 oaes 

$160 $086 

0300 9300 

OB5F 17FF 
BUFFER TABLE 

END OF RAM END OF RAM 


The program tape for the editor loads address 9100 to @B5F, and, if the 
editor is modified, at least this much must be dumped to tape, Similarly, the 
program tape for the assembler loads addresses $989 to 17FF and at least this 
much must be dumped back to tape if the assembler is modified. 
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Both the editor and assembler search for the end of memory and use as much 
memory as is available. With 8K (Recommended minimum) the assembler has a 
symbol table large enough to hold 200 svmbols, and the Editor's buffer is a 
little over 5K. 


Note that the assembler output is designed for a terminal with a 72 
character line. If it is used with a shorter terminal, the lines will be split. 
In particular, if the terminal used is the CT-1024, with it's 32 character line, 
each assembler line will turn into three lines on the terminal. 


The cassette recorder start/stop delays are tracked via a delay loop in the 
software. The times were set for the SUPERSCOPE 8 c-101A cassette recorder and 
may need to be adjusted for use with different recorders. The current delay values 
and where in memory these values lie is recorded in the following table: 


DELAY HEX BYTE TIMING ASSEMBLER EDITOR 
Record ON 3F 1.58 sec 162C PA34 
Record OFF 20 0.80 sec 163C DA44 
Read ON 30 " 1.20 sec : 1656 MASE 
Read OFF 1c 0.70. sec 1672 DATA 
Leader 64 8.90 sec 0245 : $A89 


Excpet for the leader delay, the delay values may be calculated from the 
following equation: 


H = D + 0.0251 


H is the value of the delay byte, D is the delay in seconds and .0251 is 
a software set value. The delay value must be in the range 0<D¢6.39, The 
leader delay has a built-in 6.4 seconds, so it can be adjusted in the range of 
6.4€D, 212.79. ; 


The Record ON delay should be sufficient to permit the cassette interface 
to turn on the carrier plus about 0.25 second. The Read ON delay is set equal 
to Record ON minus about .35 second. The Record OFF delay must be adjusted to 
allow the cassette tape to come to a complete stop after turn-off. The Read OFF 
should be set equal to Record OFF minus about 0.1 second. The delay must be suf- 
ficient to pass up the clear leader from a fully rewound cassette. 


Using the cassette tape version is very similar to using the paper tape as- 
sembler. To assemble a previously composed source tape follow the procedure given 
below. (The following procedure assumes that recorder A is in the READ mode and re- 
corder B is in the RECORD mode). The AC-30 cassette interface switches must be set 
to match this configuration. 

1) Load the assembler into the computer and initiate it as described 

earlier. 


2) Switch the interface to the AUTON motor control mode, 
3) Insert the source tape into recorder A. Rewind if necessary. 


4) Place recorder A in the play mode and recorder B in the record mode. The 
reels should not turn until the program is begun. 


SUPERSCOPE Risa registered trademark of the Superscope Corp. 


x 


5) Type in a IP or 18, whichever desired. The assembler will then per- 
form the first pass of the source tape. 


6) When the computer responds "M6800 RESIDENT ASSEMBLER ENTER PASS ...." 
go back to the manual mode rewind the source tape and return to the 
play and automatic mode. 


7) Place a rewound blank or previously erased tape in the B recorder. 

8) Type in the correct second pass command 2P, 2L or 2T. 

The assembler will then perform the final assembly. 

If so selected an object tape will be written on recorder B,. 
é Three additional commands have been added to the cassette tape assembler 
to allow using a printer and to allow for interfaces other than at the #1 Slot_. 
After the "ENTER PASS" command a U (port #) command will transfer cassette tape 
input/output to an extra control interface of the correct number. This con- 
figuration will be necessary to users who are using terminals which are not 300 
baud. 

Another command changes the printing of the assembly listing from the con- 
trol terminal to a SWIPC PR-40 line printer. If you have a printer connected 
to the #4 slot, for example, a P4 command should be entered. After printing 


all output is-returned to the control terminal. 
The final command is the X command. Typing an X will return control to 
the MIxBUG ® operating system. 


Notice to CT-1024 Owners 


Note that the SWIPC CT-1024 does not have a bell connected to it. When 
the EDITOR no longer echoes back what you type in you know that you have filled 
the edit buffer. 


In Case of Problems 
’ In the event that your Editor/Assembler programs do not operate correctly 
check the following: 


1) Be sure that the program was set to $100), before initiating. 


2) Be sure that the memory in use is operational. If any doubts exists 
check all locations using the ROBIT and MEMCON diagnostics. 


3) Be sure that you have at least 8K of memory in the system and that 
the two 4K boards are addressed for the "#" and "1" positions. 


4) Verify that your tape reader is 100% operational and that it is not 
misreading data. 


If paper tape programs do not run the first time try loading the tapes 


again. Sometimes paper tape is not immediately compatible between machines and 
must be loaded several times the first time through. 
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